home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / INTERNET / MAILLIST / !MailList_Docs_Install < prev    next >
Encoding:
Text File  |  1995-11-20  |  8.4 KB  |  228 lines
  1. Installing !MailList
  2. ====================
  3.  
  4.  
  5.  
  6. Upgrading from v0.11, v0.11a~c or earlier
  7. -----------------------------------------
  8.  
  9. You should first upgrade to v0.12
  10.  
  11. Upgrading from v0.12
  12. --------------------
  13.  
  14. You must first upgrade to v0.15 before upgrading to v0.16
  15.  
  16. Upgrading from v0.15, 0.16
  17. --------------------------
  18.  
  19. No remarks.
  20.  
  21.  
  22.  
  23. New Installation
  24. ----------------
  25.  
  26. If a user 'maillist' exists you have to delete this user first! MailList
  27. uses this username for it's Robots. MailList uses the existance of the user
  28. 'maillist' to flag the installation of MailList. If the user exists MailList
  29. assumes it has already installed itself on your system.
  30.  
  31. In this manual I assume that you are familiar with the operation and control
  32. of the RiscOS desktop and that you have some basic knowledge of how to send
  33. and receive e-mail via the InterNet.
  34.  
  35. What does MailList offer?
  36. -------------------------
  37.  
  38. MailList offers three basic services:
  39.  
  40. o Management of mailing-lists.
  41.         The idea was taken from LISTSERV for BITNET, ListProcessor for UN*X
  42.         and MajorDomo (Perl), to write an application that could allow you
  43.         to manage mailing-lists under the RiscOS desktop. Provided ofcourse
  44.         that your Archimedes is a node on the InterNet (via UUCP or TCP/IP)
  45.  
  46. o A simple mail-server.
  47.         As a spin-off of the mailing-list I decided to also integrate a
  48.         simple mail-server robot into MailList. The mail-server robot is a
  49.         separate service from the mailing-list. You don't need to create any
  50.         mailing-lists to be a mail-server site and vice versa. MailList
  51.         handles both separately.
  52.  
  53. o A simple scheduler.
  54.         Mail and news articles can be scheduled to be sent out at a give
  55.         date and interval. This is useful for regular postings (FAQ) or
  56.         birthday greetings, etc.
  57.  
  58. What do you need?
  59. -----------------
  60.  
  61. For MailList to run you need: 
  62.  
  63. o An Acorn RISC computer (Archimedes or RiscPC) connected to the Internet.
  64.   This can be via a modem (SLIP, PPP, UUCP) or a TCP/IP card. Provided that
  65.   NewsBase knows how to deal with the transport.
  66.  
  67. NOTE: If you are using UUCP-transport you are strongly advised to configure
  68.       it to use 'smail'! 'sendmail' behaves somewhat erratic at times. And
  69.       don't ask ME how to do this!
  70.  
  71. o 160kB of memory for MailList to run in. 
  72.  
  73. o !NewsBase v0.54n or later 
  74.  
  75. o A news/mail reader. Preferably !TTFN v0.36 or later
  76.  
  77. o !NewsDir. This is required by NewsBase so you probably have it already.
  78.  
  79. o A LARGE harddisc ;-)
  80.  
  81. o Subscribe yourself to the mailing-list about MailList by sending e-mail
  82.   To:      maillist@cray-3.xs4all.nl
  83.   Subject: SIGNON MAILLIST-L
  84.   Leave the body of the message empty as it will be ignored by the robot.
  85.   'maillist-l' is a mailing-list which is used for the discussion of bugs,
  86.   new features, problems, questions etc. of MailList.
  87.  
  88.  
  89. Installing
  90. ----------
  91.  
  92. Copy !MailList to a convenient spot on your harddisc. Preferably in the same
  93. directory where you keep !NewsBase, !TTFN and !NewsDir.
  94.  
  95. If you are going to use the mail-server option, then you should also edit
  96. the !Run file and change the definition of the variable
  97. <MailList$MailServerDir> to a sensible path for your machine. 
  98.  
  99. Double-click on the !MailList icon and watch MailList install itself
  100. automagically.
  101.  
  102. Do you have "Username access control" enabled in the "Configure users"
  103. setup of NewsBase? If so, you will have to change the 'Group no' of the
  104. user 'maillist' to 2. Otherwise, MailList won't be able to read mail from
  105. it's mailing-lists. You have to do this manually for security reasons on
  106. your part. 
  107.  
  108. That's all there is to it.
  109.  
  110.  
  111. Conventions
  112. -----------
  113.  
  114. In the text below when I use <host> or <user> I mean the following:
  115.  
  116. An address on Internet should be RFC-822 compliant and looks something like
  117. this:
  118.  
  119.         someone@machine.subdomain.domain
  120.  
  121. With <host> I mean the right part of your host's Internet address. In our
  122. example:
  123.  
  124.         <host> stands for   machine.subdomain.domain
  125.         <user> stands for   someone
  126.  
  127. In the text <host> stands for the hostname of YOUR machine on which
  128. MailList is running.
  129.  
  130. MailList assumes you have a <user> called 'root' defined on your machine.
  131.  
  132. With 'host-owner' I mean you. Assuming that you own/maintain the machine on
  133. which MailList is running.
  134.  
  135. With 'list-owner' I mean the person who maintains the mailing-list. This is
  136. usually the same person as the host-owner. But it is possible that someone
  137. else is the list-owner. It is not even neccessary that the list-owner has a
  138. mailbox on the <host>. A list-owner of a list on your <host> can be living
  139. on the other side of the world. To MailList that doesn't matter.
  140.  
  141. With 'subscriber' I mean any person who is subscribed to the mailing-list.
  142.  
  143.  
  144. How to make MailList do something
  145. ---------------------------------
  146.  
  147. When MailList is running you may notice that it has no user-interface. There
  148. are no apparent configuration options. The menu only has the standard Info
  149. and Quit items. So how *do* you tell MailList what it should do?
  150.  
  151. Well, being a mailing-list robot MailList is controlled entirely by sending
  152. it e-mail. When MailList installed itself on your system, it created a new
  153. user called 'maillist'. By sending e-mail to this user you can talk to
  154. MailList. The e-mail sent to maillist@<host> is called a 'request'. The
  155. Subject:-field of the e-mail message is used to convey the request to
  156. MailList. MailList will usually ignore the rest of the message unless
  157. specified explicitly in the documentation.
  158.  
  159. Requests are subdivided into 4 groups:
  160.  
  161. o Requests for host-owners
  162.         MailList recognizes a host-owner as the person who can send mail
  163.         from the address root@<host>, The socalled root-account on your
  164.         <host>. Since the owner/maintainer of the machine (you) is usually
  165.         the only person who can send mail from that address, this is a safe
  166.         assumption.
  167.  
  168. o Requests for list-owners
  169.         You, the host-owner, will have to tell MailList the
  170.         list-owner's Internet-address of the newly created mailing-list.
  171.         Mail received from that address will from then on be seen as mail
  172.         from the list-owner.
  173.  
  174. o Requests for subscribers
  175.  
  176. o Requests for me :-)
  177.         To keep all MailList Robots up-to-date on what is going on elsewhere
  178.         in the world, I have added a class of requests that allow me and the
  179.         Robots to talk to oneanother. These requests can only be generated
  180.         from <maillist@cray-3.xs4all.nl>. Read the file 'CyberTalk' for more
  181.         info.
  182.  
  183. To get an overview of all the requests that are accepted by this version of
  184. MailList send e-mail to maillist@<host> and give it the Subject: HELP
  185.  
  186. Requests are case-insensitive. In this manual requests are in capitals.
  187.  
  188.  
  189.  
  190. To Batch Or Not To Batch
  191. ------------------------
  192.  
  193. If memory on your machine is tight (eg. 2MB) you may notice that MailList,
  194. NewsBase and TTFN cannot run simultaneously. The best solution then is to
  195. install more memory. However, if this is not an option you can use !Alarm to
  196. start MailList on a given time. Send the request SET BATCH to
  197. maillist@<host> to make MailList process it's jobs in batches. Sending the
  198. request SET NOBATCH will make MailList a 'normal' multitasking application.
  199.  
  200. When MailList is configured to BATCH it will process all outstanding
  201. requests and mail queued for it's mailing-lists and then quit until it is
  202. started again.
  203.  
  204.  
  205. After installation
  206. ------------------
  207.  
  208. After MailList has installed itself you may want to send *your* MailList
  209. Robot (maillist@<host>) the request REGISTER. This registers your host as a
  210. user of !MailList. There are no financial consequences involved in this.
  211. Registering your host will enable you to get new updates of the software
  212. quicker. And perhaps even automatically without (or with minimum)
  213. intervention.
  214.  
  215. Silent Running
  216. --------------
  217.  
  218. If you want to use MailList together with NewsBase and run them unattended,
  219. you can achieve this fairly easily. As of v0.17 MailList reports errors
  220. without shutting down your system. As you know RISC OS application usually
  221. throw up an error-box whenever something is wrong. Ofcourse, if your machine
  222. is running unattended and needs to poll your provider's computer or better
  223. yet if you've got it hooked up to the Net, you can't use programs that
  224. hangup the entire desktop until you click OK or CANCEL. MailList will not do
  225. this. Instead it saves relevant data into a file and quits from the desktop.
  226. Leaving the error-report loaded into !Edit for your inspection. In case of
  227. problems you can email this file directly to me. ;-)
  228.